Assignment Elements

Description

The Assignment element, located in the transaction XML, describes how values should be assigned to the policy and written to AsValuation.

Type	Apply
Allocations needed?	Yes
Parameters	BUCKET	The current bucket. Must be an integer value.
	RATELOCKDATE	Date of rate lock.
Element Value	One or more MoneyType tags that define the amount and type of money to be applied.
Note: Assignment fields can be both negative (removals) and positive (additions). Removals are not validated against fund values. Hence, additions should be more than removals. The allocation records should be positive and must match total money-in amount/units or 100%.
Used when	To add Premium
Examples	Premium
	Premium Bonus

Type	ApplyByFund
Allocations needed?	No
Parameters	BUCKET	The current bucket. Must be a integer value.
	RATELOCKDATE	Date of rate lock.
Element Value	One or more MoneyType tags that define the amount and type of money to be applied. Each MoneyType must have a FUND attribute set to a FundGUID.
Note: Assignment fields can be both negative (removals) and positive (additions). Removals are not validated against fund values. Hence, additions should be more than removals. The allocation records should be positive and must match total money-in amount/units or 100%. This allows the apply to be fund specific.
Used when	To direct deposits to specific funds.
Examples	LoanRepayment

Type	RemoveByFund
Allocations needed?	No
Parameters	None
Element Value	One or more MoneyType tags that define the amount and type of money to be applied. Each MoneyType must have a FUND attribute set to a FundGUID value.
Note: Assignment values must be positive.
Used when	To direct removals from specific funds.
Examples	LoanRepayment

Type	GrossWithdrawal
Allocations needed?	Yes
Parameters	SURRENDERCHARGE	Yes, No, or a field that holds Yes or No. Whether or not a surrender charge is applied.
	SURRENDERMONEYTYPE	The type of money for the surrender charge.
	MVACHARGE	Yes, No, or a field that holds Yes or No. Indicates whether there is an MVA Charge.
	MVAMONEYTYPE	The MVA money type.
	REDEMPTIONFEE	Yes or No. Indicates whether there is a Redemption Fee.
	REDEMPTIONMONEYTYPE	The Redemption Fee money type.
	BUCKET	The bucket for the EIFund. Must be an integer value.
Element Value	One or more MoneyType tags that define the amount and type of money to be applied. The tags can have an attribute named NETFIELD.
Note: Assignment fields must be negative (removal). The allocation records should be positive and must match total money-out amount/units or 100%. This is similar to PartialWithdrawal, but the charges are applied within the removal amount.
Used when	Unscheduled money-out
Examples	Withdrawal
	Systematic Withdrawal

Type	GrossFullWithdrawal
Allocations needed?	No
Parameters	EXCLUDEFUNDTYPES	Comma-separated list of fund types. Allows funds to be excluded from the allocations that are moving money into a fund, based on the type of fund.
	SURRENDERCHARGE	Yes, No, or a field that holds Yes or No. Whether or not a surrender charge is applied.
	SURRENDERMONEYTYPE	The type of money for the surrender charge.
	MVACHARGE	Yes, No, or a field that holds Yes or No. Indicates whether there is an MVA Charge.
	MVAMONEYTYPE	The MVA money type.
	REDEMPTIONFEE	Yes or No. Indicates whether there is a Redemption Fee.
	REDEMPTIONMONEYTYPE	The Redemption Fee money type.
	BUCKET	The bucket for the EIFund. Must be an integer value.
Element Value	One or more MoneyType tags that define the amount and type of money to be applied. The tags can have an attribute named NETFIELD.
Note: Assignment fields must be negative (removals). Allocation records are created by the system with PercentInAllocation set to the ratio of the fund value to the policy cash value %. This is similar to PartialWithdrawal, but the charges are applied within the removal amount.
Used when	Total Money-out
Examples	FreeLook

Type	Transfer
Allocations needed?	Yes
Parameters	PRORATEREMOVALS	Prorate the amount to remove.
	SURRENDERCHARGE	Yes, No, or a field that holds Yes or No. Whether or not a surrender charge is applied.
	SURRENDERMONEYTYPE	The type of money for the surrender charge.
	MVACHARGE	Yes, No, or a field that holds Yes or No. Indicates whether there is an MVA Charge.
	MVAMONEYTYPE	The MVA money type.
	REDEMPTIONFEE	Yes or No. Indicates whether there is a Redemption Fee.
	REDEMPTIONMONEYTYPE	The Redemption Fee money type.
	BUCKET	The bucket for the EIFund. Must be an integer value.
Element Value	Zero or more MoneyType tags that define the amount and type of money to be applied.
Note: Assignment fields are not needed. Allocation records are needed in both negative and positive.
Used when	Money is moved from a set of one or more funds to another.
Examples	Transfer
	RebalanceAssets

XML Example

<Assignment TYPE="Apply">

<MoneyType NAME="MinusPremiumCharge">63</MoneyType>

<MoneyType NAME="MinusDeficitAccount">69</MoneyType>

</Assignment>

<Assignment TYPE="GrossFullWithdrawal">

<NegativeRemovalAmount>32</NegativeRemovalAmount>

</Assignment>

<Assignment TYPE="ApplyByFund">

<MoneyType NAME="MinusPremiumCharge" FUND="GuaranteedInterestFund">63</MoneyType>

</Assignment>

<Assignment TYPE="RemoveByFund">

<MoneyType NAME="DBGRMonthlySale" FUND="ShadowDBGFund">87</MoneyType>

<MoneyType NAME="GuarInterestMonthlySale" FUND="ShadowGUARFund">86</MoneyType>

<MoneyType NAME="NewDeficit" FUND="PolicyDeficit">69</MoneyType>

<MoneyType NAME="NewDBGDeficit" FUND="ShadowDBGDeficit">69</MoneyType>

<MoneyType NAME="NewGUARDeficit" FUND="ShadowGUARDeficit">69</MoneyType>

<MoneyType NAME="DCVDeficitNetApplied" FUND="DCVDeficitFund">69</MoneyType>

</Assignment>